home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 012a / dbview20.zip / README.DOC < prev   
Text File  |  1993-04-11  |  12KB  |  274 lines
  1.  
  2. DBVIEW.EXE is Copyright 1993    T & T Engineering    All Rights Reserved.
  3.  
  4.               By T. A. Kulaga
  5.                  P.O. Box 97000
  6.                  Kirkland, WA  98083-9700
  7.  
  8.  
  9. This version of dBVIEW is NOT public domain or free software, but is
  10. being distributed as "shareware" for EVALUATION PURPOSES ONLY.
  11.  
  12.  
  13. REGISTRATION
  14. ============
  15. To register the DOS database viewer DBVIEW.EXE program, send $10.00 to
  16. the above address and you will receive a registration serial number with
  17. instructions on how to register your copy of the program.  Registering 
  18. your copy of the program will remove the registration screen displayed 
  19. each time the program is exited.  Source code can be provided on 
  20. request to registered users for an additional $35.00 fee.
  21.  
  22. So what do you get for registering?  Good question.  You will receive a
  23. serial number which can be used to register your copy of the program and
  24. remove the annoying registration screen. Not much, is it?  Well, $10
  25. isn't much, either.  However, this is a lifetime registration.  All
  26. future revisions to this program are included in this registration.
  27.  
  28. NOTE: A disk will not be sent to you when you register, only a
  29.       registration serial number. If you absolutely need a copy sent to
  30.       you on a DISK please enclose an additional $7.00 with your $10.00
  31.       registration fee to cover the costs of shipping and handling.
  32.       Remember to specify the disk size desired.
  33.  
  34.  
  35. LICENSE
  36. =======
  37. DBVIEW is distributed as shareware for evaluation purposes only.  This
  38. means that you are granted a limited license to use it for a period of
  39. 30 days. If you find it useful and decide to continue using it after the
  40. trial period, registration is required.
  41.  
  42. Registered users will be granted a just-like-a-book license which means
  43. a registered version of the software can be used by more than one person
  44. and can be moved from one computer to another so long as there is NO
  45. POSSIBILITY of it being used by two different persons on two different
  46. computers at the same time, just like a book can not be read by two
  47. different persons in two different places at the same time.
  48.  
  49.  
  50.                                DBVIEW
  51. PROGRAM SUMMARY
  52. ===============
  53. This program is a viewer of dBASE format database files.  This includes
  54. files created by dBASE III, dBASE III+, dBASE IV, Clipper, Foxbase,
  55. Foxpro, and other dBASE compatible programs.  This program can be used
  56. as a direct replacement for the Norton Commander DBVIEW program which
  57. allows dBASE files to be viewed.  This program differs from the Norton
  58. Commander program in the number of features provided: specifically
  59. FoxPRO files can be viewed in addition to dBASE files, and memo fields
  60. can be viewed.
  61.  
  62. NOTE: To use this program in place of Norton Commander's DBVIEW program,
  63.       copy the DBVIEW.EXE file to the sub-directory containing the
  64.       Norton Commander program files.  Function key F3 in Norton
  65.       Commander will call this program whenever a .dbf file is
  66.       highlighted.
  67.  
  68. NOTE: A Windows program for viewing database files is forthcoming.
  69.       Watch for it on your local BBS.  The name to look for is DBV-WIN.
  70.  
  71. NOTE: A smaller version of this program is being developed.  It is
  72.       identical to this program except that it has been trimmed in size
  73.       by more than one third by deleting the on-line help, removing the
  74.       point and click file selection window (replacing it with a simple
  75.       text entry field), and shortening the text messages.  The purpose
  76.       of this version is to reduce the executable file size for faster
  77.       loading and less disk space usage. Watch for it on your local BBS.
  78.       The name to look for is DBV-SM.
  79.  
  80.  
  81. DEMO
  82. ====
  83. Included for demonstration and tutorial purposes is a small database of
  84. various quotes and sayings.  This database is a FoxPro database which
  85. contains memo fields and can be viewed by typing
  86.  
  87.       DBVIEW DEMO
  88.  
  89. The first memo field contains a varied amount of information which may
  90. be useful.  It discusses the various options and shows how they may be
  91. used.  The database contains the various types of fields encountered
  92. and illustrates how they are displayed.
  93.  
  94. If you like the sayings in the demo database, you may be interested in
  95. knowing that I am compiling a large database with a program which
  96. displays these sayings.  Watch your local BBS for the program titled
  97. SAYINGS.  A windows version is also forthcoming.
  98.  
  99.                                DBVIEW
  100. USAGE SUMMARY
  101. =============
  102. To start the program, at the DOS prompt use the following syntax:
  103.  
  104.     DBVIEW {filename}[.dbf]
  105.  
  106. The filename and extension are optional.  If the filename is not used, a
  107. point and click type file selection window will be opened.  The database
  108. extension must be specified if it is different than .dbf.  Any
  109. associated memo file will be opened automatically and does not need to
  110. be explicitly specified.
  111.  
  112. After the program is started, the program is controlled either by
  113. pressing the appropriate function key via the keyboard or by clicking
  114. the left mouse button when the mouse cursor is located on the desired
  115. menu function.
  116.  
  117. The cursor keys can be used to navigate through the records of the
  118. database.
  119.  
  120.         CURSOR KEY      ACTION
  121.         ----------      ------
  122.         UP              Previous record
  123.         DOWN            Next record
  124.         LEFT            Shift fields to left (oriented as in browse mode)
  125.         CTRL-LEFT       Shift fields to far left, first field first
  126.         RIGHT           Shift fields to right
  127.         CTRL-RIGHT      Shift fields to far right, last field
  128.         PAGEUP          Previous record or screen
  129.         PAGEDOWN        Next record or screen
  130.         CTRL-PGUP       Go to first record
  131.         HOME            Go to first record
  132.         CTRL-PGDN       Go to last record
  133.         END             Go to last record
  134.         ESC             Exit the program
  135.  
  136. Additionally, the mouse changes shape based on its screen location. Near
  137. the top and bottom of the screen, clicking the left mouse button will
  138. cause the previous or next record to be displayed.  Near the left or
  139. right of the display, clicking the left mouse button causes the previous
  140. or next field to be displayed.
  141.  
  142. The right side of the screen is a scrollbar for mouse movement and a
  143. relative indication of where the current record is in relation to all
  144. the records in the file.  Clicking the left mouse button on either the
  145. up or down arrows at either end of the scrollbar displays either the 
  146. first or last record, respectively.  Clicking the left button while the
  147. mouse cursor is in the upper or lower half of the scrollbar is the same 
  148. as pressing the Page-Up or Page-Down keys, respectively.
  149.  
  150.  
  151.                                DBVIEW
  152. FEATURES
  153. ========
  154. ■ Quick help                                        F1
  155.  
  156. ■ Database file info can be viewed                  F2
  157.  
  158. ■ Field info can be viewed in a scrollable window   F3
  159.  
  160. ■ Record info can be viewed in browse mode          F4 or 'B'
  161.  
  162. ■ Run WPVIEW program (Norton Commander)             SHIFT F4
  163.  
  164. ■ Specify a record number to go to                  F5
  165.  
  166. ■ View another .dbf file without exiting            F6
  167.  
  168. ■ Search for a text string                          F7 or 'F'
  169.  
  170. ■ A thermometer shows relative location in the file as the search
  171.   is being conducted.
  172.  
  173. ■ Memo fields can be viewed, one at a time          F8
  174.  
  175. ■ 25/50 line display toggle for VGA monitors        F9
  176.  
  177. ■ Deleted records are identified (The word 'DELETED' appears on the
  178.   top line, and while in browse mode * appears on left side of window.)
  179.  
  180. ■ The current record and total record count is displayed
  181.  
  182. ■ Full mouse control of menus and record/field movements
  183.  
  184. ■ Any file of dBASE format can be read, including the special files
  185.   FoxPro uses for report forms, screen formats, etc.
  186.  
  187. ■ If the database file has a bad format, Norton Commander's WPVIEW
  188.   program is loaded as a default file viewer.  This allows the file
  189.   to be viewed, one way or the other.
  190.  
  191. ■ File selection is via a point and click style window
  192.  
  193. ■ Memo fields expand to full screen width when less than 8 fields are
  194.   displayed on the screen.  Normal size is a quarter of the screen.
  195.  
  196. ■ Mouse scrollbar on the right side of the display.
  197.  
  198. ■ The default color can be changed to green on black by setting an
  199.   environment variable: SET DBVIEW=GREEN
  200.  
  201.  
  202.                                DBVIEW
  203. KNOWN BUGS
  204. ==========
  205. At this time, there is only a few known bugs or glitches in the
  206. software.
  207.  
  208. 1) After being cleared, error messages do not always restore the screen
  209.    background color. A black area is left on the screen where the error
  210.    message appeared.  This area will disappear when the screen image is
  211.    redisplayed (switching to browse mode, pressing HOME, etc.)
  212.  
  213. 2) Loading another file (F6) will stop functioning after a random number
  214.    of files (but a lot of them) have been loaded via the F6 function.  A
  215.    warning message pops up telling you that you cannot load another
  216.    file.  I'm still trying to figure this one out.  It is not fatal
  217.    since the previous file is still loaded.  Just exit and re-run the
  218.    program to view another file.
  219.  
  220. 3) The DBVIEW program is not network aware.  That is, if the database
  221.    file to be viewed is already in use and locked, the DBVIEW program
  222.    will report a GENERAL FAILURE and not be able to view the file.  This
  223.    isn't really a bug, just a feature which has not been programmed yet.
  224.    DBVIEW can read files on networks which are not being accessed by
  225.    others.
  226.  
  227. Any other bugs or program enhancements can be reported to the Author at
  228. the address above.
  229.  
  230.  
  231. ERROR MESSAGES
  232. ==============
  233. The database handling routines do numerous checks for errors: file not
  234. found, file is corrupted, out of memory, read fault, etc.  The program
  235. handles all error messages, exiting the program for fatal errors or
  236. performing other actions as appropriate.
  237.  
  238.  
  239. PROGRAMMER INFORMATION
  240. ======================
  241. dBVIEW is written in Microsoft QuickC and uses the SCL1 library of
  242. screen and mouse functions.  A library of generic database handling
  243. routines was developed to support this program and others which are
  244. being developed.  The program was compiled with the medium memory model.
  245. The intention was to provide a very compact and fast database file
  246. viewer.
  247.  
  248.                                DBVIEW
  249.  
  250. The following is provided due to the litigious society in which we live in:
  251.  
  252. WARRANTY DISCLAIMER
  253. ===================
  254. T&T Engineering provides the shareware version of dBVIEW "as is" and
  255. without any warranty.  To the extent permitted under applicable law, T&T
  256. Engineering disclaims all warranties, express or implied, including but
  257. not limited to, any implied warranty of merchantability or fitness for a
  258. particular purpose.  T&T Engineering makes no representation or warranty
  259. that the software is fit for any particular purpose.
  260.  
  261. T&T Engineering shall not be liable for any damages resulting from the
  262. use of this software, including but not limited to loss of profit, data,
  263. or use of the software or special, incidental, or consequential damages
  264. or other similar claims, even if T&T Engineering has been specifically
  265. advised of the possibility of such damages.
  266.  
  267.  
  268. Note: Microsoft QuickC, SCL1, Norton Commander, dBASE, Clipper, Foxbase,
  269.       and Foxpro are registered trademarks/tradenames of their
  270.       respective companies.  Trademarks of other companies mentioned
  271.       appear for identification purposes only and are the property of
  272.       their respective companies.
  273.  
  274.